home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xmcolor-1.0 / README < prev    next >
Text File  |  1995-06-18  |  4KB  |  114 lines
  1. #
  2. # @(#)README    1.1 94/12/05
  3. #
  4. # xmcolor - Motif(tm) Color Mixer
  5. #
  6. # by Ti Kan
  7. #
  8.  
  9.  
  10. INTRODUCTION
  11. ------------
  12.  
  13. Xmcolor is a color mixer utility for the X Window System using the
  14. OSF/Motif interface.  It is useful when setting up the color
  15. resources of various X applications, where you can browse the
  16. color database of pre-defined color names, or mix a custom color
  17. using the red, green and blue sliders.  The desired color name
  18. is shown and can be cut-and-paste'ed into an editor.
  19.  
  20. This utility is not architecture or OS platform dependent, and
  21. should be portable to any UNIX-compatible system supporting
  22. OSF Motif and the X window system.
  23.  
  24. Comments, suggestions, and bug reports about xmcolor are very welcome!
  25. Write to "ti@amb.org".
  26.  
  27.  
  28. WHERE TO GET XMMIX
  29. ------------------
  30. The source code release of xmcolor v1.0 is available via
  31. Internet anonymous FTP.  Location:
  32.  
  33.     (Instructions)
  34.     ftp.x.org:/contrib/applications/xmcolor/xmcolor-1.0.README
  35.     (gzip'd tar archive)
  36.     ftp.x.org:/contrib/applications/xmcolor/xmcolor-1.0.tar.gz
  37.  
  38. The package require the "gunzip" (GNU unzip) utility to uncompress.
  39. The source code to gzip/gunzip can be found on various FTP sites
  40. (such as prep.ai.mit.edu:/pub/gnu).
  41.  
  42.  
  43. BUILD INSTRUCTIONS
  44. ------------------
  45.  
  46. You must have X11R4/Motif 1.1 or later to build xmcolor.  Xmcolor
  47. has been successfully built under X11R4 with Motif 1.1, and X11R5 or
  48. X11R6 with Motif 1.2.
  49.  
  50. If you are running Motif 1.1, I recommend version 1.1.4 or later.
  51. Also, you must have an ANSI C compatible compilation environment.
  52.  
  53. Xmcolor can be built using the native X libraries that are supplied
  54. with your OS release.  If you have XFree86 installed, you can also build
  55. xmcolor using the libraries from the XFree86 distribution.  Make sure
  56. you use the right set of X include files to match!  Motif is not a
  57. part of the XFree86 package, so you will need to get it separately.
  58. Motif is available from various third party vendors for those OS
  59. platforms that do not come standard with the libraries and headers.
  60. If you cannot find a commercial Motif product for your platform
  61. you can also build the Motif library from the OSF sources (if you
  62. have the source license).
  63.  
  64. If your system has imake (most supported systems do), use these
  65. steps to build xmcolor:
  66.  
  67.     1. Take a look at the Imakefile, read the comments, and make
  68.        changes as appropriate.  Pay special attention to the
  69.        comments pertaining to the LOCAL_LIBRARIES=XmClientLibs
  70.        line.  You may need to change it in order to successfully
  71.        compile xmcolor.
  72.     2. Type "xmkmf" (or "imake -DUseInstalled -I/usr/lib/X11/config")
  73.     3. Type "make depend" (this step is required only if you intend
  74.        to modify the source code or header files).
  75.     4. Type "make"
  76.     5. Type "make install" to install the binary and app-defaults file.
  77.     6. Type "make install.man" to install the man page.
  78.  
  79. If your system does not have imake, use these steps to build xmcolor:
  80.  
  81.     1. Type "cp Makefile.std Makefile"
  82.     2. Edit Makefile.  You will most certainly need to make some
  83.        changes in this file to make things compile on your OS
  84.        platform.
  85.     3. Type "make"
  86.     4. Type "make install" to install the binary and app-defaults file.
  87.     5. Type "make install.man" to install the man page.
  88.  
  89.  
  90. NOTES
  91. -----
  92.  
  93. On some systems, there appears to be a problem with the vendor
  94. shell widget class in the shared Motif library.  The symptom is
  95. the following message printed on stderr:
  96.  
  97.     Error: attempt to add non-widget child "dsm" to parent
  98.     "xmcolor" which supports only widgets
  99.  
  100. Rearranging the order of the Motif and X libraries linked may
  101. alleviate this problem, and re-linking with the static Motif
  102. library instead of the shared version usually solves this problem.
  103.  
  104.  
  105. ACKNOWLEDGEMENTS
  106. ----------------
  107.  
  108. Companies names and product names appearing in this file are each
  109. trademarks of the respective company.  The names are for identification
  110. purposes only.  This software and its author are not affiliated with any
  111. of these companies.
  112.  
  113.  
  114.